home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #11 / Amiga Plus CD - 2004 - No. 11.iso / AmiSoft / Dev / gg / mc-4.6.0-mo-bi.lha / README.AMIGAOS_MORPHOS
Text File  |  2004-07-27  |  4KB  |  108 lines
  1. 1. Introduction
  2. ---------------
  3. This file describes particular issues on AmigaOS/MorphOS port of Midnight
  4. Commander.
  5.  
  6. 2. Requirements
  7. ---------------
  8. The following GeekGadgets components are necessary for running or compiling
  9. Midnight Commander:
  10.  
  11. - ncurses - for screen output
  12. - file - for file type recognition
  13. - perl - for VFS operation (transparent handling of archives)
  14. - openssh or (and) rsh - for "Shell link" function
  15. - samba - for "SMB link" function
  16.  
  17. 3. Installation
  18. ---------------
  19. - Extract the archive into your GeekGadgets tree
  20. - Go to AmigaOS shell and execute "setenv TERM amiga"
  21. - Copy file ENV:TERM to your ENVARC: directory.
  22. - If you are using VincED and wish to see mc in full colour, execute "setenv
  23.   COLORTERM 1" and copy ENV:COLORTERM file to ENVARC:. Of course you can use
  24.   this feature with standard AmigaOS or MorphOS console but they use different
  25.   colours and mc will probably look badly.
  26.  
  27. 4. Usage
  28. --------
  29. The following limitations are introduced due to missing features in
  30. ixemul.library:
  31.  
  32. - Toggling panels (CTRL-o) function does not work. When you run external
  33.   command, you will see a message: "Press any key". Press any key to return to
  34.   Midnight commander
  35. - "-d" switch for mcserv program does not work. If you need to run it in
  36.   background, use AmigaOS "Run" command.
  37. - Amiga mouse is not supported. Probably mouse support will work under
  38.   X-Window, but i can't verify it because X11R6.3 currently does not work on my
  39.   Pegasos-II system and unfortunately i have no time to research this.
  40.  
  41. "SMB Link" functions uses configuration files from Samba package. smb.conf file
  42. should be placed into /etc directory, codepages directory and lmhosts file -
  43. into /gg/lib directory. Amiga Samba looks for those files in samba:lib
  44. directory, so if you use Samba together with Midnight Commander together, you
  45. can make links to avoid duplicating files and keep configuration the same.
  46.  
  47. In ncurses v4.2 amiga terminal is defined badly, wrong sequences are used for
  48. functional keys, so sequences "Esc, number", emulating functional keys, will
  49. not work. This is okay, function keys themselves will work due to correct
  50. definition in /gg/share/mc/mc.lib. You can try to specify "amiga-h" terminal
  51. instead of "amiga" in TERM environment variable to avoid this, but this can
  52. cause conflicts with older programs using termcap, because termcap v1.3 does
  53. not have "amiga-h" terminal definition but has correct "amiga" terminal
  54. definition.
  55.  
  56. Some keys which are absent on Amiga keyboard are mapped as follows:
  57.  
  58. - Home      = Shift+Left
  59. - End       = Shift+Right
  60. - Page Up   = Shift+Up
  61. - Page Down = Shift+Down
  62. - Insert    = Help
  63. - F11...F20 = Shift+F1...F10
  64.  
  65. On Pegasos those keys on keyboard will be fully functional
  66.  
  67. 5. Compiling
  68. ------------
  69. To recompile JOE just cd to the directory with sources and type (if you use
  70. standard Amiga shell):
  71.  
  72.     sh configure --prefix=/gg --with-mcfs --with-samba
  73.  
  74. From UNIX shell (like ksh) you may just type:
  75.  
  76.     ./configure --prefix=/gg --with-mcfs --with-samba
  77.  
  78. "--with-mcfs" and "--with-samba" switches activate building support for mcfs
  79. (mcserv) and Samba networking respectively. You can omit them if you don't want
  80. them.
  81.  
  82. When the configuration process finishes, type:
  83.  
  84.     make
  85.  
  86. After compiling you may install the program by using:
  87.  
  88.     make install
  89.  
  90. To clean up the distribution (erase all binary and #?.o files) you can use:
  91.  
  92.     make clean
  93.  
  94. 6. Known bugs
  95. -------------
  96. Currently i experienced system hanging when using "Learn keys" functions over
  97. telnet (i use "vcon" server). Also ssh networking is unstable. But this
  98. probably happens due to vcon's and Amiga ssh's bugs (nothing bad happens during
  99. regular local usage from Amiga shell and during regular usage (without changing
  100. keys setup) from telnet (vt220 terminal emulator).
  101.  
  102. 7. Port author
  103. ---------
  104. My name is Pavel Fedin, i live in Russia, and you can always reach me by
  105. E-Mail:
  106.  
  107.     sonic_amiga@rambler.ru
  108.